BLE support in emulator by mmilata · Pull Request #4838 · trezor/trezor-firmware

mmilata · 2025-03-27T10:09:22Z

🐧🐧🐧 Linux-only 🐧🐧🐧

Consists of:

exposing core BLE interface to the outside as two UDP sockets, no connection state handling
trezorlib transport that talks to these sockets - as there is no connection state handling it might be useful for writing tests for e.g. misbehaving nRF but not much else
python script that launches dbus-daemon and a mock Linux BLE API on it - using env variable you can convince Suite/trezorlib to talk to it instead of the actual BLE devices

Usage:

start emu.py
start core/tools/bluez-emu-bridge.py -v
override dbus socket path export DBUS_SYSTEM_BUS_ADDRESS=unix:path=/tmp/dbus-bluez-emu-bridge
run Suite in the same environment ⬆️
same environment variable also works for trezorctl -B -p ble: ... commands

TBD in following PR(s):

launch DBus api from emu.py
configurable DBus listen address
- needed for multicore tests
- might be easier for trezor-user-env to expose a port than unix socket
t-u-e integration
add device test for e.g. pairing flow

github-actions · 2025-03-27T10:10:39Z

`en` main(all)

model	device_test	click_test	persistence_test
T2T1	test(all) main(all)	test(all) main(all)	test(all) main(all)
T3B1	test(all) main(all)	test(all) main(all)	test(all) main(all)
T3T1	test(all) main(all)	test(all) main(all)	test(all) main(all)
T3W1	test(all) main(all)	test(all) main(all)	test(all) main(all)

Translations

`cs` main(all)

model	device_test	click_test
T2T1	test(all) main(all)	test(all) main(all)
T3B1	test(all) main(all)	test(all) main(all)
T3T1	test(all) main(all)	test(all) main(all)
T3W1	test(all) main(all)	test(all) main(all)

`de` main(all)

model	device_test	click_test
T2T1	test(all) main(all)	test(all) main(all)
T3B1	test(all) main(all)	test(all) main(all)
T3T1	test(all) main(all)	test(all) main(all)
T3W1	test(all) main(all)	test(all) main(all)

`es` main(all)

model	device_test	click_test
T2T1	test(all) main(all)	test(all) main(all)
T3B1	test(all) main(all)	test(all) main(all)
T3T1	test(all) main(all)	test(all) main(all)
T3W1	test(all) main(all)	test(all) main(all)

`fr` main(all)

model	device_test	click_test
T2T1	test(all) main(all)	test(all) main(all)
T3B1	test(all) main(all)	test(all) main(all)
T3T1	test(all) main(all)	test(all) main(all)
T3W1	test(all) main(all)	test(all) main(all)

`pt` main(all)

model	device_test	click_test
T2T1	test(all) main(all)	test(all) main(all)
T3B1	test(all) main(all)	test(all) main(all)
T3T1	test(all) main(all)	test(all) main(all)
T3W1	test(all) main(all)	test(all) main(all)

Latest CI run: 18919133241

socket-security · 2025-10-24T14:58:55Z

No dependency changes detected. Learn more about Socket for GitHub.

👍 No dependency changes detected in pull request

mmilata · 2025-10-27T22:28:58Z

Thanks for the feedback @romanz, I've pushed some fixes. Did you manage to get this to work (with trezorctl or suite) on your machine?

romanz

LGTM, thanks!

Tested successfully with trezorctl & Trezor-Suite-25.10.2-linux-x86_64.AppImage (on Ubuntu 24.04.3)

romanz · 2025-10-29T08:14:18Z

+    return;
+  }
+  size_t last = drv->bonds_len - 1;
+  if (i + 1 != drv->bonds_len) {


nit:

Suggested change

if (i + 1 != drv->bonds_len) {

if (i != last) {

oof 999cda5

romanz

Device menu is now showing that BLE is enabled :)
https://data.trezor.io/dev/firmware/ui_report/18912365839/failed/T3W1_en-click_tests-device_menu-test_wipe_device.py%3A%3Atest_wipe.html

[no changelog]

trezor-ci added this to Firmware Mar 27, 2025

github-project-automation Bot moved this to 🔎 Needs review in Firmware Mar 27, 2025

M1nd3r force-pushed the m1nd3r/thp-trezorlib branch from 3cb9f35 to 8866c8e Compare March 27, 2025 12:06

mmilata force-pushed the mmilata/ble-unix branch 3 times, most recently from 5315ffc to 8665cf6 Compare March 30, 2025 20:41

M1nd3r force-pushed the m1nd3r/thp-trezorlib branch 2 times, most recently from 4d0bb99 to a5afe1e Compare April 7, 2025 17:33

mmilata mentioned this pull request Apr 8, 2025

BLE: enable advertising on firmware boot #4891

Merged

mmilata force-pushed the mmilata/ble-unix branch from 8665cf6 to df5a2a9 Compare April 8, 2025 14:59

mmilata changed the base branch from m1nd3r/thp-trezorlib to main April 8, 2025 14:59

This was referenced Oct 20, 2025

Add device tests for BLE #6041

Open

Preserve THP-BLE name cache across recovery #6020

Merged

mmilata force-pushed the mmilata/ble-unix branch 2 times, most recently from 5aa68e9 to 7d787fb Compare October 24, 2025 14:58

mmilata force-pushed the mmilata/ble-unix branch from 7d787fb to 245234a Compare October 25, 2025 21:30

mmilata marked this pull request as ready for review October 25, 2025 21:36

mmilata requested review from TychoVrahe, matejcik, obrusvit and romanz as code owners October 25, 2025 21:36

mmilata removed request for TychoVrahe and matejcik October 25, 2025 21:36

mmilata self-assigned this Oct 25, 2025

mmilata added core Trezor Core firmware. Runs on Trezor Model T and Safe models. emulator only Issue which does not appear on the physical device - but on emulator only. T3W1 Trezor Safe 7 labels Oct 25, 2025

romanz reviewed Oct 27, 2025

View reviewed changes

romanz self-requested a review October 28, 2025 07:52

romanz reviewed Oct 29, 2025

View reviewed changes

romanz approved these changes Oct 29, 2025

View reviewed changes

Comment thread python/src/trezorlib/_internal/emu_ble.py

romanz reviewed Oct 29, 2025

View reviewed changes

Comment thread core/embed/io/ble/unix/ble.c

romanz reviewed Oct 29, 2025

View reviewed changes

Comment thread core/embed/io/usb/unix/sock.c Outdated

romanz reviewed Oct 29, 2025

View reviewed changes

Comment thread core/embed/io/ble/unix/ble.c Outdated

romanz approved these changes Oct 29, 2025

View reviewed changes

mmilata added 3 commits October 29, 2025 17:31

feat(core): add emulated BLE interfaces

453b2a1

[no changelog]

feat(core/tools): BlueZ-emulator bridge

d3ccb61

[no changelog]

refactor(core): emulator socket handling

d34ce75

[no changelog]

mmilata force-pushed the mmilata/ble-unix branch from 34a560d to d34ce75 Compare October 29, 2025 16:34

mmilata added the translations Put this label on a PR to run tests in all languages label Oct 29, 2025

chore(core): update UI fixtures

b488be4

[no changelog]

mmilata merged commit 038e877 into main Oct 29, 2025
165 checks passed

mmilata deleted the mmilata/ble-unix branch October 29, 2025 20:18

github-project-automation Bot moved this from 🔎 Needs review to 🤝 Needs QA in Firmware Oct 29, 2025

Uh oh!

Conversation

mmilata commented Mar 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Mar 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

en main(all)

cs main(all)

de main(all)

es main(all)

fr main(all)

pt main(all)

Uh oh!

socket-security Bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mmilata commented Oct 27, 2025

Uh oh!

romanz left a comment

Choose a reason for hiding this comment

Uh oh!

romanz Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

mmilata Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

romanz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mmilata commented Mar 27, 2025 •

edited

Loading

github-actions Bot commented Mar 27, 2025 •

edited

Loading

`en` main(all)

`cs` main(all)

`de` main(all)

`es` main(all)

`fr` main(all)

`pt` main(all)

socket-security Bot commented Oct 24, 2025 •

edited

Loading